Consequences of an incomplete berths.txt file configuration

PrimeRoute and Expert Decking calculations are both dependent upon an accurately setup of the berths.txt file. The more sections that are filled out in the berths.txt file, the more precise the calculations. This section explains the consequences of not filling out certain sections of the berths.txt file.

The diagram below illustrates how leaving out configuration information impacts XPS calculations.

Distance diagram for a vessel discharge. For a load, d1 and d3 would be reversed.

The distance diagram above requires a basic understanding of Yard Path Modeling. Your yard path model must be set up to support vessel berth calculations for PrimeRoute and Expert Decking. For more information, see Yard path setup.

Table: Consequences of an incomplete berths.txt file configuration

	If you fill out the #BERTH section, but do not fill out the #BOLLARD or #QUAY section	If you fill out the #BERTH and #BOLLARD sections, but do not fill out the #QUAY section:	If you fill out all three: #BERTH, #BOLLARD, and #QUAY sections
Vessel Berth Calculation	Always calculated at the center of the berth, since there are no additional bollard or quay vertices to refine the distance.	Always calculated as being at the bollard at the center of the vessel.	Always calculated as being at the bollard at the center of the vessel.
Multi-Vessel Berth Calculations	If two vessels are on the same berth, they will both be centered, and consequently, they will appear to be overlapping.	Vessel centers are calculated based on the closest bollard to the vessel center.	Vessel centers are calculated based on the closest bollard to the vessel center.
Distance calculations for Distance diagram above	There is no value for d1 (for discharges) or d3 (for loads).	There is no value for d1 (for discharges) or d3 (for loads).	D = d1 + d2 + d3.
Possible calculation error	Because there is no way to determine where the vessel is located relative to the quay or berth, the distance error can be as great as the length of the berth.	While we know the location of the middle of the vessel, we do not know where the vessel is located relative to the berth. Therefore, the distance error can be as great as half the length of the berth.	Distance error = 0.
Vertices used for calculating distances	All distances will be derived from the berth vertices, which may not be refined enough to be accurate for PrimeRoute or Expert Decking moves.	Bollard vertices are used for distance calculations, which may not be refined enough to be accurate for PrimeRoute or Expert Decking moves.	Berth, bollard, and quay vertices are used for calculations. Whichever are closest are used for calculations, resulting in a distance error = 0.
Traffic	By default, only one-way traffic is supported, ingress>egress.	By default, only one-way traffic is supported, ingress>egress.	You can define the traffic, including dynamic one-way traffic.
Bay Position	There is no bay position.	There is no bay position.	Bay positions are calculated correctly.